MICROSOFT MACRO ASSEMBLER SAMPLE

     This sample demonstrates how to use CMAKE to maintain a DOS
     application that is built with the programs: MASM, CL, LIB, and
     LINK.


     TO RUN CMAKE:

        Execute CMAKE by entering the command

        cmake

        No parameters are required.


     NOTE THE FOLLOWING:

     1. The commands (and comments) in the make file, "makefile".
        CMAKE will deduce all dependencies from these commands.

        See: The Make File for CMAKE
               MASM
               * When is a MASM Command Required?
               CL
               * When is a CL Command Required?
               LIB
               * When is a LIB Command Required?
               LINK
               * When is a LINK Command Required?
             in the help file.

     2. The format of the LIB response file, "message.lrf".  CMAKE
        requires that a response file (of a particular form) be used
        with the LIB command.

        See: The Make File for CMAKE
               LIB
               * The LIB Command Line
             in the help file.

     3. The format of the LINK response file, "greeting.lnk".  CMAKE
        requires that a response file (of a particular form) be used
        with the LINK command.

        See: The Make File for CMAKE
               LINK
               * The LINK Command Line
             in the help file.

     4. The use and placement of the comment

        ; CMAKE - INCLUDE END

        in the files, "a_hello.asm" and "a_world.asm".

        In these files, this comment is placed after all include
        statements.  Although this comment is not required in assembly-
        language-source files, it serves as an end-of-file mark for
        CMAKE, and thus prevents CMAKE from searching the entire source
        file for include statements.

        See: Optimizing Performance
             * Use the End-of-Includes Comment in Your Source Files
             The Make File for CMAKE
               MASM
               * Switches for MASM
               * How CMAKE Processes an Assembly-Language-Source File
             in the help file.

     5. The use and placement of the comment

        /* CMAKE - INCLUDE END */

        in the files, "hello.c", "world.c", and "greeting.c".

        In these files, this comment is placed after all #include
        statements.  Although this comment is not required in C-source
        files, it serves as an end-of-file mark for CMAKE, and thus
        prevents CMAKE from searching the entire source file for
        #include statements.

        See: Optimizing Performance
             * Use the End-of-Includes Comment in Your Source Files
             The Make File for CMAKE
               CL
               * Switches for CL
               * How CMAKE Processes a C-Source File
             in the help file.